home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / LANG / BASIC / LIB / EVENTSHELL / DOCS / Fonts < prev    next >
Text File  |  1996-04-11  |  2KB  |  73 lines
  1. FN_shell_Fonts_Init
  2. =>    None
  3.  
  4. <=    bool    TRUE if module initialised correctly
  5.          FALSE otherwise
  6.          
  7. --------------------------------------------------------
  8.  
  9. FNshell_Fonts_GetDeskTopFont
  10. =>    None
  11.  
  12. <=    int    configured desktop font handle
  13.  
  14. This routine only returns a meaningful value under
  15. RISC OS 3.5 or higher. The font handle should be
  16. re-read before any redraw which might involve the
  17. desktop font as the font can be changed at any time
  18. by the user.
  19.  
  20. On older versions of RISC OS or if no DeskTop font
  21. is configured a value of 0 is returned to denote
  22. the 'system' font.
  23.  
  24. --------------------------------------------------------
  25.  
  26. FNshell_Fonts_FontIsAvailable()
  27. =>    str    font name i.e. 'Trinity.Medium'
  28.     real    font width in pts
  29.     real    font height in pts
  30.  
  31. <=    bool    TRUE font found, otherwise FALSE
  32.  
  33. --------------------------------------------------------
  34.  
  35. PROCshell_Fonts_FindFont()
  36. =>    str    font name i.e. 'Trinity.Medium'
  37.     real    font width in pts
  38.     real    font height in pts
  39.     int    font handle (updated on return)
  40.     
  41. This routine returns a handle for the specified
  42. font at the given size. It also causes the font
  43. to be cached for later use. If the font cannot
  44. be found the font handle is set to 0.
  45.  
  46. Taken from BLibII library 'Draw' by Tom Hughes.
  47.  
  48. --------------------------------------------------------
  49.  
  50. PROCshell_Fonts_ForgetFont()
  51. =>    int    font handle
  52.  
  53. This routine should be called when a program
  54. has finished with a font. It tells the font
  55. manager that it may uncache the font if it
  56. wishes, as it is no longer being used.
  57.  
  58. Taken from BLibII library 'Draw' by Tom Hughes.
  59.  
  60. --------------------------------------------------------
  61.  
  62. PROCshell_Fonts_SetColour()
  63. =>    int    foreground colour
  64.     int    background colour
  65.  
  66. This procedure sets the colours used for
  67. plotting outline fonts. Each of the
  68. specified colours is given as a word of
  69. the form &BBRRGG00. 
  70.  
  71. Taken from BLibII library 'Draw' by Tom Hughes.
  72.  
  73. --------------------------------------------------------